onBeforeAddRows Event

Arguments

dataObject Array

An array of rows that were added.

infoobject

An object that contains information about the event. The object can have the following properties:

typestring: Indicates the event type. The event can be 'append' or 'insert'.
indexnumber: If info.type is an 'insert', then info.index contains the index at which the data will be inserted.

Description

Fires when the .addRows() method is called before the rows are actually added.

Discussion

The onBeforeAddRows event can be used to cancel adding a row to the List control. If the event returns false, the action is not performed. For example:

Example

if (info.type == 'append') {
    alert("Appending new rows is not allowed.");
    return false;
}